Skip to content

[libspirv] Replace libclc-remangler with SYCLRemangleLibspirvPass#21588

Open
wenju-he wants to merge 16 commits intointel:syclfrom
wenju-he:move-libclc-remangler-functionality-into-new-pass
Open

[libspirv] Replace libclc-remangler with SYCLRemangleLibspirvPass#21588
wenju-he wants to merge 16 commits intointel:syclfrom
wenju-he:move-libclc-remangler-functionality-into-new-pass

Conversation

@wenju-he
Copy link
Copy Markdown
Contributor

@wenju-he wenju-he commented Mar 23, 2026

Remove libclc-remangler tool and replace it with SYCLRemangleLibspirvPass
that remangles OpenCL C mangling in libspirv to match with SYCL mangling.
The pass ports the functionalities in the tool into compile pipeline.

Motivation:

  • libclc-remangler executable doesn't fit in runtime build.
  • libclc-remangler can't justify as a standalone tool in llvm/tools.

Functional changes:

  • Add SYCLRemangleLibspirvPass. It uses Itanium demangler and adapts SPIR type system and SPIR mangler from SPIRV-LLVM-Translator.
  • The pass runs at the end of compile pipeline for each .cl file.
    libspirv variants are created without separate remangling step.
  • Drop libclc-remangler tool.

llvm-diff changes to remangled libspirv:

  • _clc functions from CLC library are now not remangled because we use
    a single clc library that defaults to OpenCL C mangling.
  • Some _clc functions from CLC library are no longer inlined for NVPTX.
    Previously, these were called only once and inlined before remangling.
    Now, because remangling can generate two caller variants, the _clc
    function is called twice, causing the inliner to skip them.
  • Changes in _CLC_DEFINE_MIPMAP_BINDLESS_READS_BUILTIN also exposed a bug in libclc-remangler which would remangle Z30__spirv_ImageSampleExplicitLodImDv4_cDv3_fET0_T_T1_iS4_S4 (correct) to Z30__spirv_ImageSampleExplicitLodImDv4_aDv3_fET0_T_T1_iS1_S1
    This bug was hidden since correct symbol was hardcoded in the source.
  • Fixed 4 __spirv_ImageArrayWrite builtins in nvptx l64.signed_char, e.g.
    _Z23__spirv_ImageArrayWriteIyiiEvT_T0_T1_i -> Z23__spirv_ImageArrayWriteIyiiEvT_T0_iT1;
    _Z23__spirv_ImageArrayWriteImiiEvT_T0_T1_i -> Z23__spirv_ImageArrayWriteImiiEvT_T0_iT1.

Remove libclc-remangler tool and replace it with SYCLBuiltinRemanglePass
that remangles SPIR-V built-ins in SYCL user device code to match OpenCL
C mangling in libspirv. The pass is inverse of what libclc-remangler did.

Motivation:
- libclc-remangler executable doesn't fit in runtime build.
- libclc-remangler can't justify as a standalone tool in llvm/tools.

Changes:
- Add SYCLBuiltinRemanglePass. It uses Itanium demangler and adapts SPIR
  type system and SPIR mangler from SPIRV-LLVM-Translator.
- Type transformations:
  - long long -> long (OpenCL has no long long)
  - long -> int (Windows or 32-bit only)
  - signed char -> char
  - char -> unsigned char (only if char is signed on the host)
  - _Float16 -> half (with a few w/a for native-cpu libdevice)
  - Address space adjustments if target's default addrspace is private.
- libspirv is now linked into user code after the optimization pipeline
  by -mlink-builtin-bitcode-postopt flag since the linking must be after
  remangling. In the future, the linking will be moved to LTO.
- Changes in _CLC_DEFINE_MIPMAP_BINDLESS_READS_BUILTIN also exposed a
  bug in libclc-remangler which would remangle
  _Z30__spirv_ImageSampleExplicitLodImDv4_cDv3_fET0_T_T1_iS4_S4_ (correct)
  to
  _Z30__spirv_ImageSampleExplicitLodImDv4_aDv3_fET0_T_T1_iS1_S1_
  This bug was hidden since correct symbol was hardcoded in the source.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@wenju-he wenju-he requested review from a team, Maetveis and cperkinsintel as code owners March 23, 2026 08:48
@wenju-he wenju-he requested a review from bratpiorka March 23, 2026 08:49
Copy link
Copy Markdown
Contributor

@Maetveis Maetveis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

libclc changes LGTM. I didn't check the new pass or any of the other changes.

When the SYCL compiler is in device mode and targeting the NVPTX backend, the
compiler exposes NVPTX builtins supported by clang.
incompatible libclc built-ins. When building a SYCL application targeting the
CUDA backend, the SYCLBuiltinRemangle pass remangles SPIR-V builtins in device
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm wondering could we make clang emit calls to these functions using the correct name mangling from the start instead of re-mangling as a pass?
I was thinking a function attribute that allows to switch the name mangling to be OpenCL compatible could theoretically work for this. We would need something similar if we wanted to author libclc sources in C++.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm wondering could we make clang emit calls to these functions using the correct name mangling from the start instead of re-mangling as a pass?

This is interesting idea, but I don't know about how to implement the automatic mapping.

We would need something similar if we wanted to author libclc sources in C++.

Implement libspirv in C++ and compile in sycl device mode like libdevice does can indeed avoid the remangling issue. However, one problem is that it will be very difficult to share implementation between libclc OpenCL and libspirv builtin wrappers, since eventually the sharing requires a stable interface which SPV-IR intends to be.

Copy link
Copy Markdown
Contributor

@elizabethandrews elizabethandrews left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FE changes just add a pass. FE changes LGTM. I have not reviewed the functionality of the pass.

…RemangleLibspirvPass

Not inlined __clc_ functions are not remangled because we only have a single clc library that has OpenCL C mangling.
@wenju-he wenju-he changed the title Replace libclc-remangler with SYCLBuiltinRemangle pass [libspirv] Replace libclc-remangler with SYCLRemangleLibspirvPass Mar 30, 2026
@wenju-he wenju-he requested a review from YuriPlyakhin March 31, 2026 05:19
Copy link
Copy Markdown
Contributor

@YuriPlyakhin YuriPlyakhin left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

4 comments left to address for files owned by me.

@wenju-he wenju-he requested a review from YuriPlyakhin April 1, 2026 03:06
Copy link
Copy Markdown
Contributor

@YuriPlyakhin YuriPlyakhin left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

one comment needs to be addressed. #21588 (comment)

wenju-he and others added 2 commits April 1, 2026 17:19
Co-authored-by: Yury Plyakhin <yury.plyakhin@intel.com>
@wenju-he wenju-he requested a review from YuriPlyakhin April 2, 2026 01:41
Copy link
Copy Markdown
Contributor

@YuriPlyakhin YuriPlyakhin left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

dpcpp-tools owned files LGTM

@wenju-he
Copy link
Copy Markdown
Contributor Author

wenju-he commented Apr 3, 2026

@intel/dpcpp-clang-driver-reviewers @intel/dpcpp-nativecpu-reviewers please review, thanks

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants